<!DOCTYPE HTML>
<html>
<head>
<title>FileGetSize | AutoHotkey</title>
<meta name="description" content="The FileGetSize command retrieves the size of a file." />
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
<script type="text/javascript">$(function(){0<=window.navigator.userAgent.toLowerCase().indexOf("ucbrowser")&&CaoNiMaDeUc()})</script>
</head>
<body>

<h1>FileGetSize</h1>

<p>获取文件的大小.</p>

<pre class="Syntax"><span class="func">FileGetSize</span>, OutputVar <span class="optional">, Filename, Units</span></pre>
<h2>参数</h2>
<dl>

  <dt>OutputVar</dt>
  <dd><p>用来保存获取的文件大小的变量名(文件大小向下取整到最近的整数).</p></dd>

  <dt>Filename</dt>
  <dd><p>目标文件名, 如果未指定绝对路径, 则假定在 <a href="../Variables.htm#WorkingDir">%A_WorkingDir%</a> 中. 如果省略, 则使用最内层<a href="LoopFile.htm">文件循环</a>的当前文件.</p></dd>

  <dt>Units</dt>
  <dd><p>如果使用此参数, 那么它会让返回结果使用的字节外的其他单位: <br>K = 千字节<br> M = 兆字节</p></dd>

</dl>

<h2>错误处理</h2>
<p><span class="ver">[v1.1.04+]</span>: 此命令失败时会抛出异常. 想了解更多信息, 请参阅<a href="Catch.htm#RuntimeErrors">运行时错误</a>.</p>
<p>如果遇到问题则 <a href="../misc/ErrorLevel.htm">ErrorLevel</a> 被置为 1, 否则为 0.</p>
<p><a href="../Variables.htm#LastError">A_LastError</a> 被设置为操作系统 GetLastError() 函数返回的结果.</p>

<h2>备注</h2>
<p>支持任意大小的文件(包括超过 4 GB 的文件), 对任意大小的文件都支持 <em>Units</em> 为字节.</p>
<p>如果目标文件为目录, 则报告操作系统看到的它的大小(在所有情况中可能都是零).</p>
<p>要计算文件夹及其所有文件的大小, 请参照此例:</p>
<pre>SetBatchLines, -1  <em>; 让操作以最快速度运行.</em>
FolderSize := 0
FileSelectFolder, WhichFolder  <em>; 提示用户选择文件夹.</em>
Loop, %WhichFolder%\*.*, , 1
    FolderSize += A_LoopFileSize
MsgBox Size of %WhichFolder% is %FolderSize% bytes.</pre>
<h2>相关</h2>
<p><a href="FileGetAttrib.htm">FileGetAttrib</a>, <a href="FileSetAttrib.htm">FileSetAttrib</a>, <a href="FileGetTime.htm">FileGetTime</a>, <a href="FileSetTime.htm">FileSetTime</a>, <a href="FileGetVersion.htm">FileGetVersion</a>, <a href="LoopFile.htm">文件循环</a></p>
<h2>示例</h2>
<div class="ex" id="ExBasic">
<p><a href="ExBasic">#1</a></p>
<pre>FileGetSize, OutputVar, C:\My Documents\test.doc  <em>; 获取以字节为单位的文件大小.</em>
FileGetSize, OutputVar, C:\My Documents\test.doc, K  <em>; 获取以千字节为单位的文件大小.</em></pre>
</div>

</body>
</html>